//
// Copyright (c) 2013-2025 The SRS Authors
//
// SPDX-License-Identifier: MIT
//

#ifndef SRS_APP_ASYNC_CALL_HPP
#define SRS_APP_ASYNC_CALL_HPP

#include <srs_core.hpp>

#include <string>
#include <vector>

#include <srs_app_st.hpp>

// The async call for http hooks, for the http hooks will switch st-thread,
// so we must use isolate thread to avoid the thread corrupt,
// for example, when dvr call http hooks, the video receive thread got
// a video and pass it to the dvr again.
// Futhurmore, the aync call never block the main worker thread.
class ISrsAsyncCallTask
{
public:
    ISrsAsyncCallTask();
    virtual ~ISrsAsyncCallTask();

public:
    // Execute the task async.
    // This method is the actual execute method of task,
    // for example, to notify callback server.
    virtual srs_error_t call() = 0;
    // Convert task to string to describe it.
    // It's used for logger.
    virtual std::string to_string() = 0;
};

// The async call worker, used to execute the task in async mode.
class ISrsAsyncCallWorker
{
public:
    ISrsAsyncCallWorker();
    virtual ~ISrsAsyncCallWorker();

public:
    virtual srs_error_t execute(ISrsAsyncCallTask *t) = 0;
    virtual srs_error_t start() = 0;
    virtual void stop() = 0;
};

// The async callback for dvr, callback and other async worker.
// When worker call with the task, the worker will do it in isolate thread.
// That is, the task is execute/call in async mode.
class SrsAsyncCallWorker : public ISrsCoroutineHandler, public ISrsAsyncCallWorker
{
// clang-format off
SRS_DECLARE_PRIVATE: // clang-format on
    ISrsCoroutine *trd_;

// clang-format off
SRS_DECLARE_PROTECTED: // clang-format on
    std::vector<ISrsAsyncCallTask *> tasks_;
    srs_cond_t wait_;
    srs_mutex_t lock_;

public:
    SrsAsyncCallWorker();
    virtual ~SrsAsyncCallWorker();

public:
    virtual srs_error_t execute(ISrsAsyncCallTask *t);
    virtual int count();

public:
    virtual srs_error_t start();
    virtual void stop();
    // Interface ISrsReusableThreadHandler
public:
    virtual srs_error_t cycle();

// clang-format off
SRS_DECLARE_PRIVATE: // clang-format on
    virtual void flush_tasks();
};

#endif
